home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / python-httplib2 / README.Debian < prev    next >
Text File  |  2009-03-02  |  3KB  |  52 lines
  1. httplib2 for Debian
  2. -------------------
  3.  
  4. Httplib2
  5. A comprehensive HTTP client library, httplib2.py supports many features left out of other HTTP libraries. 
  6. HTTP and HTTPS
  7. HTTPS support is only available if the socket module was compiled with SSL support. 
  8. Keep-Alive
  9. Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple requests over the same connection if possible. 
  10. Authentication
  11. The following three types of HTTP Authentication are supported. These can be used over both HTTP and HTTPS. 
  12. Digest
  13. Basic
  14. WSSE
  15. Caching
  16. The module can optionally operate with a private cache that understands the Cache-Control: header and uses both the ETag and Last-Modified cache validators. 
  17. All Methods
  18. The module can handle any HTTP request method, not just GET and POST.
  19. Redirects
  20. Automatically follows 3XX redirects on GETs.
  21. Compression
  22. Handles both 'deflate' and 'gzip' types of compression.
  23. Lost update support
  24. Automatically adds back ETags into PUT requests to resources we have already cached. This implements Section 3.2 of Detecting the Lost Update Problem Using Unreserved Checkout
  25. Unit Tested
  26. A large and growing set of unit tests.
  27. Usage
  28. A simple retrieval:
  29. import httplib2
  30. h = httplib2.Http(".cache")
  31. resp, content = h.request("http://example.org/", "GET")
  32.  
  33. The 'content' is the content retrieved from the URL. The content is already decompressed or unzipped if necessary. The 'resp' contains all the response headers. 
  34. To PUT some content to a server that uses SSL and Basic authentication:
  35. import httplib2
  36. h = httplib2.Http(".cache")
  37. h.add_credentials('name', 'password')
  38. resp, content = h.request("https://example.org/chap/2", 
  39.     "PUT", body="This is text", 
  40.         headers={'content-type':'text/plain'} )
  41.     
  42.     Use the Cache-Control: header to control how the caching operates.
  43.     import httplib2
  44.     h = httplib2.Http(".cache")
  45.     resp, content = h.request("http://bitworking.org/")
  46.      ...
  47.      resp, content = h.request("http://bitworking.org/", 
  48.          headers={'cache-control':'no-cache'})
  49.          
  50.          The first request will be cached and since this is a request to bitworking.org it will be set to be cached for two hours, because that is how I have my server configured. Any subsequent GET to that URI will return the value from the on-disk cache and no request will be made to the server. You can use the Cache-Control: header to change the caches behavior and in this example the second request adds the Cache-Control: header with a value of 'no-cache' which tells the library that the cached copy must not be used when handling this request
  51.  -- Matthias Jahn <jahn.matthias@freenet.de>, Mon, 31 Jul 2006 11:24:22 +0200
  52.